Writing your own modules

B. Writing your own modules

B-1. Creator and file type

The creator and the file type of a module file must be 'MUSA' and 'MODL'. The file name of a module file is listed on the preferences dialog.

B-2. Resources

Musashi reads 'cicn' resources and 'clut' resources from a module.

[Panel button icons]
The panel button icons must be represented as 24x24 color icon in 'cicn'. And they must be stored in resource ID 20001 to 20053. Each resource ID and the panel button correspond like below.

 20001 - Check mail...
 20002 - Send... (Message Viewer and Virtual Message Viewer)
 20003 - Send... (Message Editor)
 20004 - New message...
 20011 - New folder...
 20012 - Rename folder...
 20013 - Delete folder...
 20014 - Empty trash...
 20021 - Move...
 20022 - Copy...
 20023 - Trash...
 20024 - Reply...
 20025 - Forward...
 20026 - Edit...
 20027 - Save sender in Address Book...
 20028 - Filter...
 20029 - Get Info...
 20031 - Save...
 20032 - Save as template...
 20033 - Add attachment...
 20041 - New group...
 20042 - New entry...
 20043 - Rename...
 20045 - Delete
 20051 - New signature...
 20052 - Rename signature...
 20053 - Delete signatures...

[Folder icons]
The folder icons must be represented as 32x32 color icon in 'cicn'. And they must be stored in resource ID 21001 to 21064 and 21101 to 21164.
In resource ID 21001 to 21064, icons for empty folder are stored. And in resource ID 21101 to 21164, icons for folder that has some messages are stored. The icon for trash must be in resource ID 21064 and 21164. You don't need to define whole 128 (64 * 2) icons.

[Message status icons]
The icons for showing message status must be represented as 12x12 color icon. And they must be stores as resource ID 21204 from 21201 of 'cicn' resource. Each resource ID and the message status correspond like

 21201 - not opened
 21202 - opened
 21203 - not sent
 21204 - sent

And the optional icons for message status must be represented as 12x12 color icon. Each resource ID and the status options correspond like

 21296 - replied
 21297 - forwarded
 21298 - pending
 21299 - has attachments

[Icons for Address Book Editor and Signature Editor]
The icons used for Address Book Editor and Signature Editor must be represented as 12x12 color icon. They are displayed in the list of address groups, address entries and signatures. Each resource ID and each icon corresponds like

 22001 - address group
 22002 - address entry
 22003 - signature

[Icons for Message Viewer and Message Editor]
The icons used for Message Viewer and Message Editor must be represented as 12x12 color icon. Each resource ID and each icon corresponds like

 22004 - account
 22005 - siganture
 22006 - output encoding
 22007 - attachment

[Icon for remote mail]
The icons used for Remote Mail dialog must be represented as 12x12 color icon. Each resource ID and each icon corresponds like

 23001 - received
 23002 - to receive
 23003 - to delete

[Window colors]
The resource ID 20001 of 'clut' resource defines 32 of window colors. Put the window colors in the following ordering.

 Frame foreground of Folder Viewer
 Frame background of Folder Viewer
 Field foreground of Folder Viewer
 Field background of Folder Viewer
 Frame foreground of Message Viewer
 Frame background of Message Viewer
 List foreground of Message Viewer
 List background of Message Viewer
 Viewer foreground of Message Viewer
 Viewer background of Message Viewer
 Frame foreground of Virtual Message Viewer
 Frame background of Virtual Message Viewer
 List foreground of Virtual Message Viewer
 List background of Virtual Message Viewer
 Viewer foreground of Virtual Message Viewer
 Viewer background of Virtual Message Viewer
 Frame foreground of Message Editor
 Frame background of Message Editor
 Editor foreground of Message Editor
 Editor background of Message Editor
 Frame foreground of Address Book Editor
 Frame background of Address Book Editor
 List foreground of Address Book Editor
 List background of Address Book Editor
 Editor foreground of Address Book Editor
 Editor background of Address Book Editor
 Frame foreground of Signature Editor
 Frame background of Signature Editor
 List foreground of Signature Editor
 List background of Signature Editor
 Editor foreground of Signature Editor
 Editor background of Signature Editor

[Colors of message highlight]
The resource ID 20002 of 'clut' resource has 7 colors for highlighting messages to be listed in Message Viewer.

[Colors of quoted part]
The resource ID 20003 of 'clut' resource has 3 colors for highlighting quoted part of messages to be shown in Message Viewer.

B-3. Data fork

The data fork of a module file is a PICT file. The title image of a module that will be shown on preferences dialog is stored as PICT format. The maximum size for drawing title picture is 200x150. The picture exceeding this size is reduced and displayed.

[Table of contents] [Previous page]